Skip to content
last updated: {{ git_revision_date_localized }}

ome Assistant OS on Hyper-V Banner

Install Home Assistant OS on Hyper-V

This guide describes how to install the latest Home Assistant OS on Hyper-V.

Download HAOS

  • Open HAOS release
  • Scroll-down and download haos_generic-aarch64-<version>.vmdk.zip
  • Extract ZIP file

Convert VMDK to VHDX

  • Download and install Microsoft Virtual Machine Converter
  • Open Powershell as an Administrator

    Import-Module 'C:\Program Files\Microsoft Virtual Machine Converter\MvmcCmdlet.psd1'
    
    ConvertTo-MvmcVirtualHardDisk -SourceLiteralPath 'C:\Temp\haos_generic-aarch64-12.3.vmdk' -Destination 'C:\Temp' -VhdType DynamicHardDisk -VhdFormat vhdx
    
  • Wait several minutes for the conversion to complete

Create virtual machine

Recommended Hardware

  • 2 CPUs
  • 2048 MB memory
  • Disk: Move haos_generic-aarch64.vhdx under Virtual Hard Disks folder and select existing

Launch Home Assistant

Install HACS (Home Assistant Community Store)

Reference Documentation

  • Install SSH add-on
  • Set password
  • Start SSH service
  • Run wget -O - https://get.hacs.xyz | bash -
  • Navigate to Settings > Devices & Services > Integrations
  • Clear browser cache
  • Hard reload browser using Shift-Refresh
  • Click on + Add Integration
  • Search for HACS and install
  • Follow on-screen instructions

Add Integration

Add Automation Hardware

Zigbee Hardware

Add Security Hardware